home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1992 …SCII & the Runetime Code / ADC Developer CD (1992-07) (''Butch ASCII And The Runtime Code'')_iso / Dev.CD 199207.iso / Developer Essentials / DTS Sample Code / System 7.0 Samples / AEObject-Edition1.0.2 Sample / Where do I Look???? < prev    next >
Encoding:
Text File  |  1992-03-09  |  4.0 KB  |  100 lines  |  [TEXT/MPS ]
  1. Where Do I look for what I want?????
  2. This is a rather large sample, and it combines two major areas, AppleEvents
  3. and the Edition Manager.  I have tried to break up the source files
  4. into easy to understand chunks, so you can find what you need without too 
  5. much flailing around in code you don't care about.
  6. Here's a breakdown of what each file contains....
  7.  
  8. Files 
  9. :obj:    just a directory.  Needs to be here so the Make file knows where to put the 
  10.         object files
  11. AEObject.c    AppleEvent Object Model code.  If you are interested in working
  12.             with the AppleEvent™ Object Model (and you should be) this is the 
  13.             file you should look in for seeing Object Accessor routines, Object
  14.             Packing routines, OSL callbacks, and the AppleEvent Handlers
  15.             for AppleEvents that take objects as their direct object.
  16. Sampdefines.h    This file includes all the other headers needed
  17.  
  18. AEObject-Edition Sample.make    The make file.  Oh, you already knew that?
  19.  
  20. AESample.rscr        Copy of all the non-code resources
  21.  
  22. Structs.h    All the structures used in this sample
  23.  
  24. AEUtilities.c    Some handy common AppleEvent routines.
  25.  
  26. AppleEventCore.c    The core AppleEvent code.  This is the file that
  27.                     installs all the AppleEvent Handlers, handles all the
  28.                     Required and some of the Edition Manager AppleEvents,
  29.                     calls AEProcessAppleEvent, and handles the AppleEvent 
  30.                     dialog boxes
  31.  
  32. BuildHeaders.c    A file that builds and dumps all the header (.h) files
  33.                 into a precompiled version.  If you are NOT using precompiled
  34.                 headers in MPW C yet, you SHOULD!!!! They will save you 
  35.                 at least 40% of your current compile time.
  36.  
  37. Files.c        Handles file opening and saving.  Also writes out and reads
  38.             my preferences file.  Uses the new StandardFile calls, FSSpecs,
  39.             and the FindFolder routine.
  40.  
  41. globals.c    Application globals.  There are more globals here that you would probably 
  42.             want in a 'real' application, I kept many things as globals for the
  43.             sake of clarity.
  44.  
  45. Initialize.c    Application initialization routines.
  46.  
  47. Macros.h    All the macros (not many) that I use in this app.
  48.  
  49. main.c        The main event loop for this app.
  50.  
  51. Menu.c        Uhhhh, handles menu stuff. Also has some of the self-contained
  52.             Dialog boxes (like the About box).
  53.  
  54. NewDialog.h    New Dialog manager calls for System 7.  See Tech Note #304
  55.  
  56. Print.c        Minimal printing routine.
  57.  
  58. prototypes.h    All the prototypes for this application
  59.  
  60. Publish.c    Publisher routines.  Almost all the code used for handling
  61.             publishing is in this file.  Publisher dialog, writing Publisher 
  62.             data, handlers for the Publisher AppleEvents, and some other routines
  63.             are here.  However, there are some publishing routines that 
  64.             are very similar to Subscriber routines, and they will be in the 
  65.             Subscribe.c file.
  66.  
  67. '•Read Me•'    Simple read me
  68.  
  69. SampConstants.h    Constants for this application
  70.  
  71. Subscribe.c        All the subscriber code for this application.
  72.                 Subscriber dialogs, option dialogs,
  73.                 reading AppleEvent handler, and all the routines 
  74.                 that deal with Sections on the ClipBoard are in this file.
  75.  
  76. TextSections.c    This file contains the minimal handling I do of text subscribers
  77.                 and publishers.  This is the weakest section, since I am using 
  78.                 TextEdit for my word processor.  However, it will give you
  79.                 an idea of how to do publishing and subscribing in text,
  80.                 and show you one way of doing it.
  81.  
  82. Utilities.c        Utility routines.  Nuff said.  Steal these and use them.
  83.  
  84. Windows.c        My window handling code.  Window creation, window drawing,
  85.                 hit testing, and all that other nastiness is in here.  If it has
  86.                 to do with windows, I hope I put it here.
  87.  
  88.  
  89. And that's the lot.  If this is not organized in a helpful way, please let me know
  90. and I will change things.  If you do like it, let me know so I have both
  91. sides of the story.
  92. Also, if the comments in any section are not clear enough, please tell me.
  93. I want this to be a solid reference for AppleEvents and the Edition Manager,
  94. and if the comments aren't clear I haven't done my job.
  95.  
  96. C.K. Haun
  97. AppleLink C.K.HAUN
  98. Apple Developer Technical Support
  99.  
  100.